home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat7 / ethernet.z / ethernet
Encoding:
Text File  |  2001-04-17  |  12.9 KB  |  331 lines
  1.  
  2.  
  3.  
  4. EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))                                                        EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ethernet - Ethernet controllers
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      IRIX supports local-area networking with Ethernet.  The Ethernet protocol
  13.      is supported with a hardware controller and a kernel driver.  Though the
  14.      controllers are different among the various hardware platforms, their
  15.      drivers provide the same programming interface to networking routines.
  16.  
  17.      Most ethernet controllers are named using the following convention:  the
  18.      prefix is `e' and the suffix ('N') is the controller unit number.
  19.      However, not all drivers follow this, as shown below:
  20.  
  21.           Name Type      Model
  22.           ec0  on-board  Indigo, Indigo2, Indy, CHALLENGE S/M (10baseT)
  23.           ec0  on-board  O2 (10/100baseTX)
  24.           ec1  PCI       O2 (10/100baseTX)
  25.           et0  on-board  POWER Series, Challenge/Onyx systems (10baseT)
  26.           etN  HIO       POWER Series, Challenge/Onyx systems (10baseT)
  27.           ef0  on-board  OCTANE, Origin Series Fast Ethernet (10/100baseTX)
  28.           efN  XIO       OCTANE, Origin Series Fast Ethernet (10/100baseTX)
  29.           epN  HIO       CHALLENGE/Onyx, POWER CHALLENGE/POWER Onyx (10baseT)
  30.           fxpN VME       CHALLENGE/Onyx, POWER CHALLENGE/POWER Onyx (10baseT)
  31.           gfeN GIO       Indy, Indigo, Indigo2, CHALLENGE S (10/100baseTX)
  32.           vfeN VME       CHALLENGE/Onyx, POWER CHALLENGE/POWER Onyx (10/100baseTX)
  33.  
  34.      Depending on the model, several Ethernet controllers are supported,
  35.      allowing the system to act as a gateway among different local networks.
  36.  
  37.      The Ethernet boards are initialized during system startup from
  38.      /etc/init.d/network (see _n_e_t_w_o_r_k(1M) for details).
  39.  
  40.      IRIX implements the Ethernet encapsulation format.  Each packet has a
  41.      14-byte header, as defined in the #include file <_n_e_t_i_n_e_t/_i_f__e_t_h_e_r._h>:
  42.  
  43.           struct ether_header {
  44.                u_char    ether_dhost[6];     /* destination address */
  45.                u_char    ether_shost[6];     /* source address */
  46.                u_short   ether_type;    /* packet type */
  47.           };
  48.  
  49.  
  50.      The packet type determines which kernel protocol routine is called to
  51.      process the packet data.  Examples of common packet types are IP, ARP,
  52.      and DECnet.
  53.  
  54.      On systems with 10/100baseTX capability, auto-negotiation is enabled by
  55.      default; through auto-negotiation, the ethernet transceiver will select
  56.      the highest performance common connection technology between a local host
  57.      and a remote host.  For the OCTANE and Origin systems, refer to
  58.      /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_i_f__e_f if the manual selection of ethernet speed and
  59.      duplex mode is desired.  For the O2 on-board ethernet, the PROM variable
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))                                                        EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))
  71.  
  72.  
  73.  
  74.      'ec0mode' can be used to select the desired speed (legal values are:  10,
  75.      100, f100, and h100).  For the O2 add-on ethernet, refer to
  76.      /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_i_f__e_c_f if the manual selection of ethernet speed and
  77.      duplex mode is desired.
  78.  
  79.      To disable auto-negotiation and force a specific speed/duplex, you can
  80.      modify the /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_i_f__e_f file with the following changes.
  81.      As the following example shows, you must specify _x_x_x as a valid phy type,
  82.      specify _y_y_y as a valid speed/duplex mode, and remove the #ifdef/#endif
  83.      lines.
  84.  
  85.      In addition, you must set the ethernet unit number to -1 to activate the
  86.      chipset features on all interfaces (this is the default in this file, as
  87.      shown in the following example), or set it to a specific interface number
  88.      that will affect only that interface.
  89.  
  90.      The example is as follows:
  91.  
  92.      To lock down the ef0 interface on an Origin 2000 system to 100mbit/full-
  93.      duplex, specify the following:
  94.  
  95.      { 1, PHY_DP83840, -1, 0, 0xffff, F100 },
  96.  
  97.      To lock down the ef1 interface on an Octane system to 10mbit/half-duplex,
  98.      specify the following:
  99.  
  100.      { 2, PHY_ICS1890, -1, 0, 0xffff, H10 },
  101.  
  102.      You must also remove the #ifdef/#endif lines.
  103.  
  104.           */
  105.           #define F100    0x2100                       /* 100mbps full duplex mode */
  106.           #define H100    0x2000                       /* 100mbps half duplex mode */
  107.           #define F10     0x0100                       /* 10mbps full duplex mode */
  108.           #define H10     0x0000                       /* 10mbps half duplex mode */
  109.  
  110.           struct phyerrata {
  111.                int             unit;
  112.                __uint32_t      type;
  113.                short           rev;
  114.                unsigned short  reg, mask, val;
  115.           } ef_phyerrata[] = {
  116.                { -1, PHY_DP83840, -1, 23, 1 << 5, 1 << 5 },  /* bypass link disconnect */
  117.                { -1, PHY_ICS1890, -1, 18, 1 << 5, 1 << 5 },  /* link loss inhibit */
  118.           #ifdef notdef
  119.                { -1, xxx, -1, 0, 0xffff, yyy },
  120.           #endif
  121.                { -1, 0, 0, 0, 0, 0},
  122.           };
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))                                                        EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))
  137.  
  138.  
  139.  
  140.      Auto-negotiation for the gigabit Ethernet 1000Base-SX differs from auto-
  141.      negotiation for IEEE 802.3u 100BaseT. 100BaseT uses the National
  142.      Semiconductor NWay (TM) Auto-Negotiation standard.  Most of the 10/100
  143.      Ethernet controller chips include N-Way Auto-Negotiation.
  144.  
  145.      There is no auto-negotiation standard for 1000Base-SX; this may require
  146.      that auto-negotiation be disabled. To disable auto-negotiation, you must
  147.      use the following commands:
  148.  
  149.           ifconfig eg<n> down
  150.           egconfig -l eg<n>
  151.           ifconfig eg<n> up
  152.  
  153.  
  154.      If you need to reenable auto-negotiation, you must reboot the system
  155.      because the auto-negotiation status of a system cannot be checked.
  156.  
  157.      The default for auto-negotiation is to be enabled on bootup.  If you want
  158.      auto-negotiation to be disabled by default, you must create the
  159.      /_e_t_c/_c_o_n_f_i_g/_e_g<_n>._o_p_t_i_o_n_s file and add the -l option (letter l).
  160.  
  161.      Whether or not auto-negotiation is enabled or disabled, the speed and
  162.      mode will always be 1,000 Mbits/second, full duplex.
  163.  
  164. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  165.      Various error messages are printed by the kernel when a problem is
  166.      encountered.  The message is preceded by the controller name, for
  167.      example, et0.  Serious errors are flagged with a dagger (|-).  If they
  168.      occur repeatedly, contact your product support service for assistance.
  169.      By default, many non-serious errors will not cause a diagnostic message
  170.      to be displayed on the console.  To enable all driver diag messages, use
  171.      the command iiiiffffccccoooonnnnffffiiiigggg xxxxxxxxxxxx ddddeeeebbbbuuuugggg where xxx is the ethernet network
  172.      interface name.
  173.  
  174.      The following error messages are common to all controllers:
  175.  
  176.         packet too small (length = X)
  177.         packet too large (length = X)
  178.              The controller received a packet that was smaller than the
  179.              minimum Ethernet packet size of 60 bytes or larger than the
  180.              maximum of 1514.  This problem is caused by another machine with
  181.              a bad Ethernet controller or transceiver.
  182.  
  183.         stray interrupt
  184.         early interrupt
  185.              The controller interrupted the kernel before the device was
  186.              initialized.  This error is innocuous; it occurs after booting a
  187.              kernel over the network from the PROM monitor.
  188.  
  189.         died and restarted
  190.              The controller failed to respond after a certain amount of time
  191.              and the driver had to reset it.
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))                                                        EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))
  203.  
  204.  
  205.  
  206.         cannot handle address family
  207.              This message indicates an error in the kernel protocol handling
  208.              routines.|-
  209.  
  210.      The following messages are specific to the ec and et controllers.
  211.  
  212.         no carrier: check Ethernet cable
  213.              Carrier was not detected when attempting to transmit, probably
  214.              because the Ethernet cable is unplugged from the machine (but
  215.              possibly due to a broken transceiver, transceiver cable, or
  216.              10baseT hub).
  217.  
  218.         late collision
  219.              The controller tried to transmit a packet but received a late
  220.              collision signal from another machine.  Usually indicates a
  221.              problem in the Ethernet cable layout.
  222.  
  223.         transmit buffer error
  224.         receive buffer error
  225.         transmit underflow
  226.         receive packet overflow
  227.              The controller ran out of memory when trying to transmit or
  228.              receive a packet.|-
  229.  
  230.         unknown interrupt
  231.              The controller interrupted the kernel but the reason for the
  232.              interrupt is missing.|-
  233.  
  234.         babbling
  235.              The kernel tried to transmit a packet larger than the maximum
  236.              size.|-
  237.  
  238.         machine has bad Ethernet address: x:x:x:x:x:x
  239.              The Ethernet address obtained from non-volatile RAM during
  240.              controller initialization was corrupted.|-
  241.  
  242.         memory timeout
  243.              The LANCE Ethernet chip failed to access its local memory.|-
  244.  
  245.      Counts of Ethernet input and output errors can be displayed with the
  246.      command _n_e_t_s_t_a_t -_i (see _n_e_t_s_t_a_t(1M)).  Typically, output errors and
  247.      collisions occur due to mismatched controller and transceiver
  248.      configurations.  Input error statistics include counts of the errors
  249.      listed above and counts of protocol input queue overflows.
  250.  
  251. CCCCoooonnnnffffiiiigggguuuurrrriiiinnnngggg aaaaddddddddiiiittttiiiioooonnnnaaaallll eeeetttthhhheeeerrrrnnnneeeetttt ppppoooorrrrttttssss oooonnnn CCCChhhhaaaalllllllleeeennnnggggeeee////OOOOnnnnyyyyxxxx LLLL////XXXXLLLL ssssyyyysssstttteeeemmmmssss
  252.      Onyx and Challenge L/XL systems only enable the ethernet on the master
  253.      IO4 by default.  To activate the ethernet interfaces on other IO4 boards,
  254.      a vector line must be added to ////vvvvaaaarrrr////ssssyyyyssssggggeeeennnn////ssssyyyysssstttteeeemmmm////iiiirrrriiiixxxx....ssssmmmm. The following
  255.      vector line configures the ethernet interface on the IO4 in slot 13 as
  256.      et1:
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))                                                        EEEETTTTHHHHEEEERRRRNNNNEEEETTTT((((7777))))
  269.  
  270.  
  271.  
  272.      VECTOR: bustype=EPC module=epcether unit=1 slot=13
  273.  
  274.      The first two options (bustype and module) are mandatory and tell lboot
  275.      that you're configuring an ethernet interface.  The "unit" option
  276.      specifies the ethernet unit number. The unit number must be greater than
  277.      0.  The "slot" option specifies the slot of the IO4 whose ethernet
  278.      interface is being configured as et1.
  279.  
  280.      After updating the iiiirrrriiiixxxx....ssssmmmm file, autoconfig(1m) should be executed to
  281.      reconfigure the kernel.  To make the new interface available, reboot the
  282.      machine with the new kernel.
  283.  
  284. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  285.      ioconfig(1M), netstat(1M), network(1M), socket(2), drain(7P), ip(7P),
  286.      raw(7P), snoop(7P)
  287.  
  288. NNNNOOOOTTTTEEEE
  289.      IEEE 802.3 Ethernet encapsulation is not currently supported.  Some
  290.      Ethernet controllers will support IEEE 802.3 and Ethernet v.1/v.2
  291.      electrical specifications.  Contact your product support service for more
  292.      information.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.